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Directory M-E ERS 84/06/15 

\ 1.0 INTRODUCTION 



o 






1.0 miKDQUCIIDM 



1.1 HURODUCUilii 

The Directory M-E provides a registration and translation 
service. A title and corresponding address are registered. A 
user can reques-t a translation of the title and get the 
address. The Directory H-E does not validate the title or 
address. 



1.2 £ii£££££ 

The purpose of Directory M-E is to 

1) Register a title and corresponding address over a specified 
Translation domain. If requested, periodically distribute the 
title over a specified Distribution Domain. 

2) Translate a title. Return one or more addresses for a 
matched title over a specified search domain. If the title 
cannot be translated, the translation service will continue 
searching for the title for a specified time. 



1.3 ££££££!i££S 

1. CDC Network Architecture GDS IARH4243) 

2. Xerox Internet Entity ERS by R. Woodruff (ARH6221) 

3. Routing M-E EPS by N. L. Reddy (ARH626A) 

A. Executive ERS BY F. J. BAKER (ARH4976) 

5. CDCNET Program Interface Handbook by C. A. Rykken 
tARHXXXX) 
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2.0 ££AIHE£H££iaL£-ffit£iiiI£H 



2.1 ££AIU££5iS£EiiI££S 



The services offered by the Directory M-E are 



1) Maintain a Registered User Data Store (RDS) which contains 



) Maintain a Registered User Data Store CRD 
II the titles registered by users in this 
f title may be regi stered*e.g» end-user nam 
ames, etc. 



ail the titles registered cy u«n m «..»».» system. Any tv Pjj 
of title mav be realstered,e.g» end-user names* filenames, M-E 

names, 

2) Maintain a Translation Data Store <TDS> which contains 
titles registered in remote systems which have been translated 
in this system. The Translation Data Store also contains 
those titles registered in remote systems which have been 
distributed to this system. The TDS contains entries for 
titles translated/received in the last "our. TDS entries, 
cider than one hour are purged. Also »f the TDS entries 
exceed a limit, the least recently used entry will be purged. 
If two TDS entries have the same title and address, the most 
recently created entry is retained and the other entry is 
dt scarded. 

3) Maintain a Translation Request Data Store (TRDS) "*««£ J« 
used to process requests for translation by users in this 

system. 

The layers and entities of the system are users of the 
Directory M-E. 



2.2 £ilM£IIOH^i_R£lAIin!iSai£i 

2.2.1 REGISTRATION FEATURE 

The user can create, change, or delete a directory entry. 
The interface Is via CALL/RETURN. The following diagrams 
illustrate these features. 
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2.0 FEATURE/SERVICE OVERVIEW 
2.2.1.1 Create Directory Entry 



2.2.1.1 £££ai£_P-Lr.e.c.io.r.i«LiLtrjt 



USER 

: create 

: directory 
s entry 



— + 



Directory M-E 

01 r M-E 
puts title 
In RDS 



♦ 






sbroadcast title: 

•>: to remote DIs • 

: In title * 

: domain if 
: distribution 
: Is requested 



2.2.1.2 £iianfl£ J2ir.££i£r.*_EiiiiJ£ 



^•tau-^ 



USER 

i change 
s existing 
s directory 
: entry 



>, 



t 



Directory M-E 

: Dir M-E 
finds title 
in RDS £ 
changes 
attr ibutes 



^broadcast title: 
•>: to remote DIs s 
: In title * 
: domain If * 
: distribution J 
: is requested : 



2.2.1.3 n£i £ i £ _Eir.£c.tai.*_Enir.ji 



USER 

? delete 

: existing 

: directory 

s entry 



Directory M-E 

♦ + 

: Dir M-E 
->: finds title 
: in RDS & 
s deletes 
s dir entry 



— > 



broadcast title: 
deletion to * 
remote DIs in 
the title 
domain If 
distribution 
was requested 



o 
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2.2.2 TRANSLATION FEATURE 



2.2.2 TRANSLATION FEATURE 



The translation feature provides a means to obtain one or 
more addresses for a given title. The Translation Request is 
via a CALL/RETURN. The confirm/reject is at the RETURN of the 
ca 1 1 • 

The Translation Indication is via a CALL/RETURN to a user 

procedure supplied in the Translation Request. The user may 

terminate the Translation Request at the RETURN of user 
procedure. 

The user can specify two different types of search: active 
and passive. The active search actively requests titles from 
all the systems in the search domain. The user can specify a 
search time for the active search. The Oirectory M-E 
terminates the request when this time has depleted with a 
CALL/RETURN to the user procedure supplied in the Translation 
Request. The passive search waits for titles to be 
distributed periodically. There is no time limit for the 
passive search* that is* the user must explicitly abort a 
passive Translation Request. 

The user can wait for the Translation Request to complete 
with a CALL/RETURN. The Directory M-E returns to the user 
after the Translation Request has terminated. The user can 
also abort the Translation Request at any time with a 
CALL/RETURN. 

A Purge Translation Entry Request is provided to enable the 
user to delete a Directory Entry from the Translation Data 
Store. Thus* the user will not get the same Directory Entry 
in a subsequent Translation Request unless that entry is still 
in the original system. Note* this can be used by the user 
when a connection to a title (service) fails and the user 
wants another title. The following diagrams illustrate the 
translation feature. 
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2.0 FEATURE/SERVICE OVERVIEW 
2.2.2.1 Translation Request 



2.2.2.1 JjLailS.UULaQ-.Rfiaue.st 



USER 

t tr 
: ti 



DIR 
♦ 



ans 
tie 



late : 



V 



— + 



« 

I 

V ♦ 






-—- +• 



Jbuild TROS : >: 

• « 



\ TRDS J 
: \ entry?* 

:TRDS \N0 : 

:entry?\then : 

:YES Vend.: 
+ + 






+— 
:se 
:to 
:se 

:en 




:cal 1 user proce 
:wlth indication 
->:user wants requ 
saborted* delete 
tTRDS entry 



+ 

dure: 

. If: 

est : 
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nd translation request * 

remote OIs in the : 

arch domain ' 

d. * 
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2.2.2.2 Haii_la£-Itanfilaiifln-££aiifi5t 



USER 

+ + 

: wait for : 
: translation 
: request 



Directory M-E 

4. + 



+ 



— + 



>: 

! 

: 



Dir M-E 
finds title 
req in TRDS 
and gives 
the CPU. 



+ + 

: DIR M-E returns: 

— // >: to user when 

: the request 

: has completed. 
: 



2.2.2.3 4&o.r_.t_l£aD.£lailaQ-&£au£&i 



USER 

: abort 

: translation 

J request 



Di rectory 
♦ 






+— 



— ♦ 



M-E 



Dir M-E 
finds title 
req in TRDS 
and deletes 
the entry 



->: 
: 



Return to user 
wi th conf i rm 
that request 
was aborted. 



V y 






2. 2. 2. 4 £niLa£.IxaDalailaD-£ni£i-R£flU£si 



USER 

J purge * 

: translation 

: data store 

: entry 



Directory M-E 









♦—- 



— + 



Dir M-E 
finds title 
in TDS 
and deletes 
the entry 



— + 

: Return to users 

>: with confirm J 

: that TDS entry: 
: was purged. : 
: : 
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2.0 FEATURE/SERVICE OVERVIEW 
2.3 UTILIZED EXTERNAL INTERFACES 



2.3 UIlUZ£fl_EKI£BJiAL-l!UEREA££S. 



The Directory M-E must communicate with remote Oirectory M-Es 
In order to satisfy titie translation requests with search 
domains other than the local system. The Directory M-E must 
also distribute to remote Directory M-Es registered titles 
with a distribution domain other than the local system. 



2.3.1 ROUTING M-E INTERFACE 

In order to communicate with remote Directory M-Es> the 
Directory M-E must open a 3B-SAP. First, Directory waits for 
a translation of the "Sap Assigner" title and then it calls 
the returned procedure to open a 3B-SAP. A dedicated 3B-SAP 
title of n directory_sapid" is supplied. See the Routing ERS 
for a description of the calling parameters. 

The Routing M-E must maintain the NETWORK_TITLE_ENTRY table 
which is a list of all network addresses and corresponding hop 
counts in the catenet. The Routing M-E must register all 
community titles received in Routing Information Data Units 
from remote Routing M-E's. The Directory M-E uses these 
network and community addresses to communicate to remote 
Directory M-E's. 



2.3.2 INTERNET INTERFACE 

The Directory M-E uses the Internet entity to send and receive 
POUs from remote Directory M-Es. See XEROX Internet ERS for a 
description of the interface. 
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3.0 FEATURE DESCRIPTIONS 




(f 


3.0 E£AIi!££-J2ESCSI£IIDaS 






\ 



The Directory M-E supports registration and translation of 
directory entries. When titles are compared during 
registration or translation* the shorter title is padded with 
blanks to match the length of the longer title before the 
comparison is done. 



3.1 £££IiI&AIIQiLF£AIUR£ 

All layers and entities are candidates as users of the 
Registration feature. Users must include in their calling 
modules a *CALLC DRXDIR which defines the TYPE declarations 
and the XREF declarations for the Directory M-E procedures. 
It also defines the parameter attributes for these procedures. 



3.1.1 INITIALIZE REGISTRATION CONTROL BLOCK 

The registration routines all use the registration control 
block* DIR.RCB. An Inline procedure is provided called 
DIR RCB INIT which initializes the control block to all 
defaults. The defaults are defined with the parameter 
descriptions in the Create Directory Entry section. 

PROCEDURE CINLINE3 dir_rcb_init (VAR dir.rcbs dir_rcb_r ec) ; 
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3.1.2 CREATE DIRECTORY ENTRY 

The user creates a directory entry in the Registered User Data 
Store (RDS) with a CALL/RETURN. If there Is already an entry 
jn RDS with the same title* service attribute, and address* an 
error will be returned. 

PROCEDURE tXREFl dir_create (dir.rcb: dir_rcb_rec; 
VAR dir.lds dir.id.rec) dl r.status.codes J 




%»»ir 



1) DIR^RCB Directory registration control block. The 
*** record structure follows: 

TYPE 

dl r_rcb_rec * record 

title.ptr* "string ( * <- max_ti tl e_len), 
service: dir_service> 
translation.domain: ( I oca I .system, 

t ist.of.communi ties, catenet), 
distr ibutlon_domaln: ( I i st_of_commun I ties, 

catenet, none), 
co»munity_ptr: "array I 1 •• * 3 of 

string (max_communi ty_l en), 
password? <0 .. FFFFFFFF>, 
address? d I r_address_r ec, 

userinfo_ptr: "string ( * <* max.useri nfo.Ien), 
priority: <l .. FF>, 

cl ass: {cdna_lnternal , cdna_external ), 
recendj 



title ptr The pointer to the title string. The title 

is a string of 1 to 255 ASCII (Parity Bit « 

0) characters. Max_t it1e_len is 255 

characters. This Is the only required field 
in this control block. 

service A parameter that defines the highest layer 
end-to-end CDNA protocol to be used to 
communicate with this entry. Service is 
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o 



defined as a ordinal. If the ordinal is 
zero* this entry has a directly accessible 
service value of unknown. Unknown is the 
def aui t. 

TYPE 

dir_service» (unknown* xerox.lnternet* xerox_transport* 
generic_transport> x25_support.J ayer* 
interactive_transfer_service)j 

trans I ation_domai n 

This parameter is used to identify where in 
the network the translation request can 
originate and be translated. Default is 
catenet. Note that a title registered with a 
Translation Domain of local.system cannot be 
obtained outside of the local system. 

distr lbution_doma in 

This parameter is used to identify where in 
the network the. title is to be distributed 
after registration. Default Is- catenet. ^ } 
Note that the Distribution Domain must be a ; 
subset of the Translation Domain. Also* if a V,,/ 
I I st_of_communi ties is specified for both 
domains* the list must be the same for both 
domains. Note* a distr i butlon.domain must be 
specified if this title is intended for 
translation with a passive search type. See 
the Translation Request for details. 

community_ptr This parameter is only used if Translation 
Domain and/or Distribution Domain is set to 
1 lst_of_eommunlties. Communi ty.ptr Is a 
pointer to an array of community titles. 
There can be up to 16 community titles. The 
community title is a string of 1 to 32 
characters* Note* the "Communi ty n prefix is 
not to be included in the title. Trailing 
blanks are deleted. 

password The password to be associated with this 
directory entry. This value must be supplied 
on a Change or Delete request. Password is 
defined as an integer. Default is zero. 

address The address record. Address is a variant k 

record. The default address type is 

CONTROL DATA PRIVATE 
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O 



system_addr. If the network ID field is 
zero* "the network ID and system ID of the 
local system is stored in the address field 
by Directory M-E for address types 
system_addr*i nternet_addr> and 

transport_addr. The record structure for 
di r_address_rec fellows: 



TYPE 

d1r_address_type « (system_addr> internet_addr» 

transport_addr# non_network_addr* record.addr* proc_addr ) } 

TYPE 

system_address » record 

network.ld: <0 .. FFFFFFFF>* 
system.id: <0 .. FFFf FFFFFFFF>t 
r ecend; 

TYPE 

dir_address.rec * record 

case addr.type: di r_address_type of 
• system_addr ■ 

systems system_address> 
= internet_addr « 

internet: J nternet_address> 
» tr ansport_addr « 

transport: gener ic_sap» 
~ non_network_addr x 

addr.data: SEQ CREP 14 of cell)* 
■ record_addr » 

record_ptr: *cell» 
= proc_addr * 

proc_ptr: A procedure» 
casend 
recend; 

userinfo ptr The pointer to the user information string. 
If userinfo. ptr is NIU then there is no user 
inf ormation'suppl ied. Max.user inf o_len is 32 
characters. 

priority A number which specfies the relative priority 
of this entry as compared with other 
directory entries with the same title. By 
convention* 1 is the highest priority. 
Default is 1. 
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3.0 FEATURE DESCRIPTIONS 
3-1.2 CREATE DIRECTORY ENTRY 



cl ass 



An ordinal which identifies the originator of 
this title. The values are CDNA internal or 
CDNA external. Default is CDNA internal. 



21 DIR.ID 



Directory entry identifier. This parameter 
is returned if the create was successful. 
The directory entry identifier uniquely 
identifies this Directory Entry. It consists 
of the local system address and current 
decimal time. The record structure follows* 



TYPE 

dir„.id_rec ■ record 

system_addrs system_address» 

decctock: bcd«.time» 
r ecendj 



3) DIR_CREATE 



Status is returned In the procedure name. 
Oir_create Is set to di r_cr eate_ok if this 
request is confirmed* otherwise* this CREATE 
request is rejected— 



dir.status.codes 

di r_create_ok 
di r.no.roou 

dir_title_err 
dir_address_err 
di r_useri nf o_err 

dir_communi ty.err 
dir_domai n_err 

di r_dupl icate 



description 

title added to directory 

no room for directory entry. Error 

returned from Allocate. 

title length not 1-255 

address record invalid 

userinfo_!en or userlnfo_ptr out of 

range 

community pointer length out of range 

distribution domain not subset of 

translation domain 

existing entry with same 

ti tle#address# and service attribute. 
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3.1.3 CHANGE DIRECTORY ENTRY 

The user changes an existing directory entry in the Registered 
User Data Store (RDS) with a CALL/RETURN. The title, 
password, and directory entry identifier must match an 
existing entry in RDS. The user must supply a change set 
which specifies which parameters are to be affected. 

PROCEDURE CXREF1 dir.change (dlr_rcb: dir_rcb_rec; 
dir_change_ef fectors: di r_change_set J 
VAR dirlids dir_id_rec> dir.status.codes* 



1) DIR_RC8 Directory registration control block. It has 

the same record structure as in dir_create. 
It is not possible to change a title and 
password with this call. The other 
parameters are changed in the existing 
directory entry if the change effector bit 
was set by the user. 

2) DIR_CHANGE A set which specifies the parameters which 

may be changed in the directory entry. The 
parameter change bit must be set for the 
change to occur. 

TYPE 

dlr_change_set » set of (address.change, user i nf o_change> 
serv i ce_change* trans I at lon_domain_change> 
distr ibution_domain_change» comrauni ty.change, 
pr ior i ty_change)» 

3) DIR.ID The current directory entry identifier. On a 

change* it must be supplied by the caller. 
The dir_id Is updated to reflect the change 
and returned to the user In this parameter. 

4) DIR.CHANGE Status is returned In the procedure name. 

Dlr_change is set to dlr_change_ok if this 
request is confirmed, otherwise this CHANGE 
request is rejected — 

dir_stttus_codes description 

dir_change_ok title changed in directory 
dir!entry_not_found cannot find directory entry 

CONTROL DATA PRIVATE 
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dlr_tltle_err title length not 1-255 
dlr~address_err address record Invalid 
dir.userlnfo.err userinfo_len or userlnfo_ptr out of 

range 
dir^domal n.err domain out of range 
dlrZconimunl ty_err community pointer length out of range 



, ) 
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3.1.4 DELETE DIRECTORY ENTRY 



The user deletes an existing directory entry In the Registered 
User Data Store (RDSJ with a CALL/RETURN. The title, 
password, and directory entry identifier must match an 
existing RDS entry. 



PROCEDURE CXREF1 dir. delete (dir.rcb: dir_.rcb_.reci 
VAR dlr_ids dir_ld_rec) d ir_status_codes; 



c 



1) DIR_RCB 



2) DIR_ID 



Directory registration control block. It has 
the same record structure as in dlr_create. 
The only parameters processed by delete are 
the title pointer and the password. The 
other parameters ar*e ignored. 



The current directory entry 
delete* it must be supplied 



identifier. On 
by the caller. 



3) DIR.DELETE 



Status is returned in the procedure name. 
Dir. delete is set to d lr_delete_ok if this 
request is confirmed, otherwise this DELETE 
request is rejected — 



dir_status_codes 

di r_.delete._ok 

di r_entry_not_f ound 

dir_title_err 



description 

title was deleted from the directory 
cannot find directory entry 
title length not 1-255 



#*> 
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3.2 IEAttSLAHQtl-ESAIUEE 

AM layers and entities are candidates for users of the 
Translation feature. Users must include in their calling 
modules a *CALLC DRXDIR which defines the TYPE declarations 
and the XREF declarations for the Directory li-E procedures. 
It also defines the parameter attributes for these procedures. 



3.2.1 INITIALIZE TRANSLATION CONTROL BLOCK 

The translation routines use the translation request control 

block* DIR_TCB. An Inline procedure is provided called 

DIR_TCB_INIT which initializes the control block to all 
defaults — 

PROCEDURE tlNLINE] dir.tcb.lnit (VAR dir_tcb* dir_tcb_rec ) ? 



CONTROL DATA PRIVATE 



d 



3-10 
Directory H-E ERS 



84/06/15 



c 



'^ 3.0 FEATURE DESCRIPTIONS 

3.2.2 TRANSLATE DIRECTORY TITLE 



o 



^^^ir 



3.2.2 TRANSLATE OIRECTORY TITLE 

The user requests a title translation with a CALL. The RETURN 
notifies the user of a confirm/reject status of the translate 
request. The translation indication is via a CALL/RETURN to 
the procedure identified in the translate request control 
block (see the trans lat i on.i f parameter). 



PROCEDURE IXREF] d i r.tr ans I ate (dir.tcbt dir_tcb_rec; 
VAR dir.tid: dir_1d_rec) dir_status_codes; 



1) DIR_TCB Directory translation request control block. 
~* The record structure follows* 

TYPE 

dir_tcb_rec * record 

title_ptrs *string ( * <« max„ti tl e_len), 
services dlr_ service* 

search.domaint {I ocal.system* community* catenet), 
communi ty_ptrs *array t 1 .. * 1 of 

string ( max,_communi ty_f en)» 
user.lds A cell» 
translation.! fs "procedure tdir_ticb: di r_ticb_rec; 

VAR abort_translatlon„requests boolean)* 
search. typeT Cacti ve.search* pass! ve_search)* 
time* .. di r„max_ti»e» 
class: (cdna_ internal* cdna_external )* 
wild_card: boolean* 
r ecend; 

title ptr The pointer to the directory title to be 
translated. The title is a string. 
Max_title_!en Is 255 characters. If the 
wlld.card value is FALSE* the title is 
matched character for character. If the 
wild.card value is TRUE* the title may have 
wild-card characters. This means the 
following characters have special meaning — 

? Represents any single character 

* Represents any string of characters 
including the null string. The •*• 

CONTROL DATA PRIVATE 



Directory N-E ERS 



3-11 
84/06/15 



3.0 FEATURE DESCRIPTIONS 

3.2.2 TRANSLATE DIRECTORY TITLE 



/* ?: '' fr '"> 



K.J 



may be ambiquous. For example* 
ABA+ABA is correctly satisfied byt 

ABAABA 

ABAABAABA 

ABAA8AABAABA 

A8A_any_other_str i ng_ABA 

A maximum of 5 **s are allowed as wild 
card characters in a title. 

C...1 Matches any single character among a 
group of characters in brackets. 
Within a bracketed group* the subrange 
notation A..Z where 'A* and *Z* are 
any two characters means match any 
single character which Is in the range 
A through Z. 

C A ...l Hatches any single character except 
those in brackets. Within a bracketed 
group* the subrange notation *A..Z 
where »A» and *Z' are any two |1^) 
characters means match any single 
character which is not in the range A 
through Z. 

For example* the following wild card 
titles would match the following 
registered titles* 

TRANSLATION TITLE REGISTERED TITLES 

AI1233T A2T 

A3T 
Xt A B..E3J XFJ 

XAJ 

» If the registered title contains any 
wild-card characters as part of the 
complete title* those characters must 
be surrounded with single quotes in 
the translation title name. If the 
registered title contains a single 
quote as part of the title* 2 single 
quotes must be in the translation 
title name. For example* the 
following wild card titles would match 
the following registered titles: 

CONTROL DATA PRIVATE 
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TRANSLATION TITLE REGISTERED TITLES 

A**'* A*123 

A*B 

A*ZZZ 
b?»?» bl? 

bZ? 
C ti c« 

Q*i[]E* QABCC3E 

QZET3E 

service A parameter that must match the service 
attribute of the registered directory entry. 
Service Is defined as a ordinal. If the 
ordinal is "unknown"* the Service parameter 
Is not used as part of the match criteria. 

TYPE 

dlr. service * (unknown* xerox.internet* xerox_transport» 

gener i c.transport* x25_support_l ayer* 

interactlve_transfer_service) j 

community ptr This parameter Is only used if domain is set 
to I ist_of_communl ties. Communi ty.ptr is a 
pointer to an array of community titles. 
There can be up to 16 community titles. The 
community title is a string of 1 to 32 
characters. Note* "Community " is not to be 
included. Trailing blanks are deleted. The 
communities will be searched in the order 
specified in the array* 

search domain The domain where a search for the title is to 
be made. Default is catenet. The Directory 
N-E will guarantee that a title registered 
outside the search domain will not be 
returned as a translation indication. 

us er id A user supplied pointer. This pointer is 
returned on a translation indication and 
translation termination indication. 

trans1ation_lf The pointer to the procedure which will 
receive any translation indications and 
translation termination indications. This 
procedure has two parameters. The first 
parameter is the translation indication 
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o 



control block which Is defined in a later 
section. The second parameter Is set TRUE by 
the user procedure if the translation request 
should be aborted or FALSE if the translation 
request should continue. 

search_type The type of search to be performed. Possible 
values are "active" and "passive". An 
"active" search actively requests 
translations from systems in the search 
domain. Duration of the search is determined 
by time. An "active" search guarantees that 
translation indications are unique. A 
"passive" search waits for translations to be 
distributed periodically. A "passive" search 
continues until terminated by the user* that 
Is* time is ignored for a "passive" search. 
A "passive" search does not guarantee that 
translation indications are unique. The 
default search_type is "active". 

• • /-^ 

time The time in seconds to spend searching for % i j 

the title. Time is only used for a 
search.type of "active". The minimum value 
Is seconds and the maximum value is 24 
hours. Default Is 12 seconds. Note* 
seconds only is meaningful for a search 
domain of local_system. 

class The user classification value that must match 

the registered directory entry. Class can be 
CDNA internal or CDNA external. The default 
is CDNA internal. Note* a CDCNET external 
user cannot translate CDNA internal titles. 

wild.card Wild.card parameter. A boolean parameter as 
defined above in title_ptr. Default is 
FALSE. 

2) DIR.TID The translation request identifier. This 

field uniquely identifies the translation 
request. It is returned when the translation 
request is confirmed. Note* this translation 
request identifier must be supplied on an 
abort translation request. It has the same 
record format as dir_ld_rec. 4"~~\' 
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3.2.2 TRANSLATE DIRECTORY TITLE 



3) DIR_TRANSLATE Status is returned in the procedure name. 

Dir.transiate is set to dir.translate.ok if 
this request is confirmed* otherwise this 
TRANSLATE request is rejected — 

dir.status.codes description 

dir_translate_ok translation request confirmed 

dirltitle.err" title length not 1-255 

dir_address_err address record invalid 

di rZdomain_err domain or relays out of range 

dir_eommuni ty — err community length out of range 






\t> 
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3,2.3 WAIT FOR TRANSLATION REQUEST f \ 

3.2.3 WAIT FOR TRANSLATION REQUEST 

The user can wait for a Translation Request to complete 
with a CALL. Directory M-E will not return control to the 
user's RETURN until after the Translation Request has been 
aborted by the user via the user's trans I ati on_i f procedure. 
This assures the user that at least one translation has 
occured or the search time has depleted before control is 
returned. 



PROCEDURE tXREFl dlr_*ait (dlr.tids d|r_id_rec)j 

1) DIP.TID The translation request identifier. This 

parameter was returned on a translation 
request. 
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3.2.4 ABORT TRANSLATION REQUEST 

The user can abort a directory translation request with a 
CALL. The RETURN from the call notifies the caller that the 
request for termination has been confirmed or rejected. 

PROCEOUPE [XREF1 dir.abort (dir_tid: dlr_id_rec> di r_status_codes? 

1) DIR_TID The translation request • identifier. This 

parameter was returned on a translation 
request. 

2) DIR ABORT Status is returned in the procedure name. 

Dir_abort is set to dir_abort_ok if this 
translation request has been terminated* 
otherwise this translation request has not 
been terminated. 

dir_status_codes description 

dlr_abort_ok translation request terminated 

dirlabor tlerr translation request not found 
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3.2.5 PURSE TRANSLATION ENTRY REQUEST \Jt 

3.2.5 PUR6E TRANSLATION ENTRY REQUEST 

The user can purge an existing Translation Data Store entry 
with a CALL. The RETURN from the call notifies the caller 
that the entry has been purged or the entry could not be 
found. Note* the user can use this call to purge an old 
directory entry out of the Translation Data Store in this 
system. It does not affect the Registered User Data Store. 
If the user falls to connect to a service* the user can issue 
this Purge Translation Entry Request to insure that a 
subsequent Translation Request will not return the same 
directory entry unless that directory entry is still In the 
original (registered) system. 

PROCEDURE IXREF3 dir.purge (title: string ( * <« max_t i 1 1 e_Jen) ; 
dlr_ids dir_ld_rec) di r_status_codes J 

1) TITLE The title for the directory entry. This 

title was returned in the Translation 
Indication. x l 



2) DIR_ID The directory entry identifier. This 

parameter was returned on the translation 
indication. 

3) DIR.PURGE Status is returned in the procedure name. 

Dir_purge is set to dir_purge_ok if this 
translation data store entry was purged* 
otherwise this entry could not be found. 



dlr.status.codes description 

dir_purge_ok Translation Data Store entry purged 

dir^entrylnot.f ound cannot find directory entry in TDS 



K...S 
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3.2.6 USER PROCESS PROCEDURE 



The Directory M-E calls the procedure whose entry point Mas 
specified in the translation request control block when a 
requested title has been found* the translation request has 
been terminated due to search time depleted, or there are no 
more titles in the directory at this time. The definition for 
the user procedure is repeated: 

translation^ifJ ^procedure <dlr_ticb: di r_ticb_r ecj 
VAR abort.transl ation„request: boolean). 

For the response code d ir_srch_time, the Directory M-E 
aborts the translation request. For the response codes 
dir.indi cat! on and dir_ind icat ion_done» the Directory M-E 
looks at the ~ user returned parameter, 
abort_translation_request» to determine whether the 
translation request should be aborted. The Directory M-E does 
not guarantee that the title is not out of date. If the user 
attempts to connect to a returned directory entry and the 
connection fails, the user can call dtr_purge to i*nsure that 
the same directory entry will not be returned for a subsequent 
Translation Request if the directory entry is no longer in the 
original system. The translation indication control block 
f o i lows: 
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3,2.6 USER PROCESS PROCEDURE 



TYPE 

dlr_response_code • {dir_lndicat Ion* dir_indication_done> 
dir_srch_tlme) J 

TYPE 

dir,_ticb_rec - record 
user_l d: *cel l» 

case response.code: di r_response„,eode of 
» dir_indieat i on « 

dir.id* dlr.ld_.rec> 

title_ptrs "string ( * <■ max.ti t I e_l en) » 

address: dir_address_rec» 

user inf o.ptr : "string < * <» max.userinf o_! en) » 

service: dlr_service> 

priority: <1 •. FF>» 
* dl r_indicat i on_done * 

» 
■ dl r_srch_time * 

f 
casend 
recendj 

user_Jd The pointer that was supplied by the user on 
the translation request. See the translation 
request control block. 

response_code The response code for directory translation 
indication is dl r.lndi cation. The response 
code for directory translation termination is 
dir.srch.tlme. If one or more translation 
indications were returned* the sequence is 
ended with a response code of 
dlr_indicat ion_done to indicate to the user 
that there are no more titles in the 
directory at this time. 

dlr_id The directory entry identifier which 
identifies the matched title entry. The 
record structure is the same as defined in 
DIR.CREATE. 

tltle_ptr The pointer to the title string. 
Max_title_len is 255 characters. 

address The address record. The address is a variant 
record. The record structure is the same as 
defined in DIR.CREATE. 
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userinfo_ptr The pointer to the user Information string. 
If userlnfo_ptr is NIL* then there is no user 
information. 

service A parameter that defines the highest layer 
end-to-end CDNA protocol to be used to 
communicate with this entry. Service is 
defined as a ordinal. If the ordienal is 
zero* this entry has a directly accessible 
service value of unknown. Unknown Is the 
default. 

TYPE 

dir_service * (unknown* xerox. internet* xerox_transport» 
gener ic.transport* x25_support_l ayer* 
interacti ve_transf er .service) ; 

priority A number which specfies the relative priority 
of this entry as compared with other 
directory entries with the same title. By 
convention* 1 is the highest priority. 
Default is 1. 



\J 
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4.1 QmAIHi£-£HAaA£I£Eim$:S 

The critical performance question is the amount of physical 
memory needed to hold the directory tables. The fixed size of 
the RDS and TDS entry Is < 92 bytes. Therefore the size of 
the RDS and TOS entry Is 92 bytes plus the variable fields. 
The variable fields are the title* password* user information* 
and communities. The fixed size of the TROS entry is < 98 
bytes. Therefore* the size of the TRDS entry is 98 bytes plus 
the variable fields. The variable fields are the title* 
password* old directory identifiers* and communities. 

The memory requirement for the directory module will be less 
than 15k bytes. Stack space required for directory will not 
exceed 2k bytes. 

The average execution time is as follows* * ^ 

SERVICE TIME IN MILLISECONDS 

CREATE 3 

CHANGE 5 

DELETE 2 

TRANSLATE 8 

ABORT 2 

These times are based on an average of 100 entries in RDS and 
TOS and 25 entries in TRDS. 



4.2 QffiRAIIIHlAL-flEASU&lOIS 



The following statistics are maintained by Directory M-E: 

1. Number of entries in RDS 

2. Amount of memory allocated for RDS entries 

3. Number of entries in TDS 

4. Amount of memory allocated for TDS entries 

5. Number of entries in TRDS 



o 
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6. Amount of memory allocated for TRDS entries 

7. Number of requests satisfied In ROS 
8* Number of requests satisfied In TOS 

9. Number of requests satisfied by a Protocal Data Unit 
response. 



o 
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5.0 £UUI£-SIAI£_liA£aiiiE 



The FSM is supplied in a separate document. 
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The following software errors will be logged by Directory M-E< 



LOG MESAGE ID 

dwe_open_3b_.saP.err or 

DESCRIPTION 

Directory M-E cannot open 3B sap during initialization 

83/10/14 11:00:35 12345678JABC 

Directory M-E cannot open 3b sap during Initialization 



LOG. MESAGE ID 

dme_bui ld_trds_er ror 

DESCRIPTION 

Directory M-E. No space to build TRDS table ITRDU). 

83/10/14 11100:35 12345678JABC 
No space to build TRDS table (TRDU). 



LOG MESAGE ID 

dme_bul I d_tds_error 



DESCRIPTION 

Directory M-E — no space to build TDS table tTDU). 

83/10/14 11*00*35 12345678JABC 
No space to build TDS table CTRDU). 
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LOG HESAGE ID 

drae_al I o caterer ror_rcv_du 

DESCRIPTION 

Directory H-E cannot get space for received PDU. 

83/10/14 1UOOS35 12345678JABC 
No space for received PDU. 



LOG HESAGE ID 

dme_a I locate_error_send_du 

DESCRIPTION 

Directory H-E cannot get space for sending PDU. 

83/10/14 11:00135 12345678JABC 
No space for sending PDU. 



LOG WESAGE ID 
dme_bad_pdu 



DESCRIPTION 

Directory M-E received bad Internet PDU. 



! HASK 

{fixed text ! type 



! LOG_MESSAGE_BUFFER_PTR A {variable part) 



! value 



description 



i— . 



! binary ! 2 octet i Length of Protocol Data 
J octets ! ! Unit 



! LENGTH 

i 

• 

! PDU ! binary ! 1 .. 32 ! The first 32 octets of the J 
J ! octets i octets ! Bad Protocol Data Unit ! 



! 



83/10/14 12J15S36 123456789ABC 

Directory M-E received illegal Internet message. 

Length * 525. PDU = 0007987654321A8C123456789A**{ >12. 



CONTROL DATA PRIVATE 



Directory M-E ERS 



7-1 
8W06/15 



/"> 7,0 INSTALL 



ATION OPTIONS 



7.0 IHilAILAIIOti-QRIIQliS 



none 
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8.0 U£M_QAIA_IIR£S 



Data types defined in above sections of this ERS are: 

1) dir_rcb_rec Directory registration control block 

2) dir_address_rec Directory address record 

3) dlr_id Directory entry identifier 

4) dirldomain Directory domain types. 

5) dlr_servlce Directory directly accessabie service 

designation 

6) dlr_tcb_rec Directory translation request controi 

block 

7) dir tid Directory translation request 

identifier 

8) dir_ticb_rec Directory translation indication 

control block 



o 
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9.0 £LJ3SSA2LI- 
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